home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2000 #4 / Amiga Plus CD - 2000 - No. 4.iso / Tools / Dev / SpeakFreely_Src / gsm / install < prev    next >
Encoding:
Text File  |  2000-05-27  |  2.5 KB  |  92 lines
  1.  
  2. /*
  3.  * Copyright 1992 by Jutta Degener and Carsten Bormann, Technische
  4.  * Universitaet Berlin.  See the accompanying file "COPYRIGHT" for
  5.  * details.  THERE IS ABSOLUTELY NO WARRANTY FOR THIS SOFTWARE.
  6.  */
  7.  
  8. How to get started:
  9.  
  10.    Edit the Makefile.
  11.  
  12.     You should configure a few machine-dependencies and what
  13.     compiler you want to use.
  14.  
  15.       The code works both with ANSI and K&R-C.  Use
  16.     -DNeedFunctionPrototypes to compile with, or
  17.     -UNeedFunctionPrototypes to compile without, function
  18.     prototypes in the header files.
  19.  
  20.    Make addtst
  21.  
  22.     The "add" program that will be compiled and run checks whether
  23.     the basic math functions of the gsm library work with your
  24.     compiler.  If it prints anything to stderr, complain (to us).
  25.  
  26.    Edit inc/config.h.
  27.  
  28.    Make
  29.  
  30.        Local versions of the gsm library and the "compress"-like filters
  31.     toast, untoast and tcat will be generated.
  32.  
  33.        If the compilation aborts because of a missing function,
  34.     declaration, or header file, see if there's something in
  35.     inc/config.h to work around it.  If not, complain.
  36.  
  37.    Try it
  38.  
  39.     Grab an audio file from somewhere (raw u-law or Sun .au is fine, 
  40.         linear 16-bit in host byte order will do), copy it, toast it,
  41.     untoast it, and listen to the result.
  42.     
  43.     If it doesn't sound anything like the original, read the manual.
  44.     If it still doesn't sound anything like the original, complain.
  45.  
  46.  
  47. Installation
  48.  
  49.    You can install the gsm library interface, or the toast binaries,
  50.    or both.
  51.  
  52.    Edit the Makefile
  53.     
  54.     Fill in the directories where you want to install the
  55.     library, header files, manual pages, and binaries.
  56.  
  57.     Turn off the installation of one half of the distribution
  58.     (i.e., gsm library or toast binaries) by not setting the
  59.     corresponding directory root Makefile macro.
  60.  
  61.  
  62.    make install
  63.  
  64.     will install the programs "toast" with two links named
  65.     "tcat" and "untoast", and the gsm library "libgsm.a" with
  66.     a "gsm.h" header file, and their respective manual pages.
  67.  
  68.  
  69. Optimizing
  70.  
  71.    This code was developed on a machine without an integer
  72.    multiplication instruction, where we obtained the fastest result by
  73.    replacing some of the integer multiplications with floating point
  74.    multiplications.
  75.  
  76.    Another possibility is the use of a lookup table; you can turn on
  77.    this feature by replacing -DUSE_FLOAT_MUL by -DUSE_TABLE_MUL.
  78.  
  79.    If your machine does multiply integers fast, define neither.
  80.  
  81.  
  82.  
  83. Bug Reports
  84.  
  85.    Please direct bug reports to toast@tub.cs.tu-berlin.de.
  86.  
  87.  
  88. Good luck,
  89.  
  90.    Jutta Degener,
  91.    Carsten Bormann
  92.